WhatsApp Templates [Desarrolladores]
Gestiona tus plantillas de WhatsApp (HSM): consulta, crea, actualiza y sincroniza templates desde la API.
WhatsApp Templates
La API de Adereso permite gestionar tus plantillas de WhatsApp (HSM) de forma programática. Puedes consultar las plantillas existentes, crear o actualizar plantillas, hacer actualizaciones masivas y sincronizar templates desde Meta.
¿Para qué sirve?
Las plantillas de WhatsApp (también llamadas HSM o templates) son mensajes pre-aprobados por Meta que tu empresa puede enviar a clientes fuera de la ventana de 24 horas. Sin una plantilla aprobada, no puedes iniciar conversaciones por WhatsApp.
Beneficios concretos
- Automatizar el primer contacto con clientes: confirmaciones de pedido, recordatorios de citas, avisos de envío
- Mantener sincronizadas las plantillas entre Meta y Adereso sin intervención manual
- Actualizar plantillas en lote cuando cambian tus procesos o campañas
¿Quién lo usa? Equipos de operaciones, marketing y tecnología que necesitan gestionar plantillas de WhatsApp de forma programática desde sus propios sistemas.
Consultar plantillas
/v2/whatsapp/templates/ - GET
Obtiene las plantillas de WhatsApp almacenadas en tu cuenta. Puedes filtrar por cuenta, ID de plantilla o idioma.
Parámetros
Parámetro | Tipo | Requerido | Descripción |
account | string | No | UID de la cuenta WhatsApp para filtrar |
template_id | string | No | ID específico de plantilla |
language | string | No | Código de idioma (ej: 'es', 'en') |
Ejemplo de request
curl -H "Authorization: Key TU_TOKEN" \
"https://api-cluster.adere.so/v2/whatsapp/templates/?account=56900000000&language=es"Ejemplo de respuesta exitosa:
{
"status": 200,
"templates": [
{
"template_id": "abc123",
"name": "bienvenida_cliente",
"body": "Hola {{1}}, bienvenido a {{2}}",
"lang": "es",
"status": "APPROVED",
"category": "MARKETING"
}
]
}Códigos de error
Código | Descripción |
401 | Token de autenticación inválido o no proporcionado |
Crear o actualizar una plantilla
/v2/whatsapp/templates/ - PUT
Crea una nueva plantilla o actualiza una existente en Adereso. Esta operación registra la plantilla localmente para que pueda ser utilizada al enviar HSMs.
Parámetros
Parámetro | Tipo | Requerido | Descripción |
account | string | Sí | Número de teléfono de la cuenta WhatsApp (ej: '56900000000') |
name | string | Sí | Nombre de la plantilla (ej: 'confirmacion_pedido') |
body | string | Sí | Texto de la plantilla con parámetros {{1}}, {{2}}, etc. |
lang | string | Sí | Código de idioma (ej: 'es', 'en_US') |
namespace | string | Sí | Namespace de la cuenta WhatsApp Business |
media_url | string | No | URL del archivo multimedia asociado |
category | string | No | Categoría: MARKETING, UTILITY, AUTHENTICATION |
components | array | No | Componentes de la plantilla (header, body, footer, buttons) |
department_ids | array | No | IDs de departamentos asociados |
status | string | No | Estado de la plantilla |
template_id | string | No | ID de la plantilla (para actualizaciones) |
Ejemplo de request
curl -X PUT \
-H "Authorization: Key TU_TOKEN" \
-H "Content-Type: application/json" \
"https://api-cluster.adere.so/v2/whatsapp/templates/" \
-d '{
"account": "56900000000",
"name": "confirmacion_pedido",
"body": "Hola {{1}}, tu pedido #{{2}} ha sido confirmado.",
"lang": "es",
"namespace": "mi_namespace"
}'Ejemplo de respuesta exitosa:
{
"status": 200,
"message": "Template created successfully"
}Códigos de error
Código | Descripción |
400 | Faltan parámetros obligatorios o formato inválido |
401 | No autenticado |
Crear o actualizar plantillas en lote
/v2/whatsapp/templates/bulk/ - PUT
Permite crear o actualizar múltiples plantillas en una sola llamada. Ideal para sincronizar un catálogo completo de templates.
Parámetros
Parámetro | Tipo | Requerido | Descripción |
templates | array | Sí | Array de objetos template, cada uno con los mismos campos que el endpoint individual |
Ejemplo de request
curl -X PUT \
-H "Authorization: Key TU_TOKEN" \
-H "Content-Type: application/json" \
"https://api-cluster.adere.so/v2/whatsapp/templates/bulk/" \
-d '{
"templates": [
{
"account": "56900000000",
"name": "bienvenida",
"body": "Hola {{1}}, bienvenido",
"lang": "es",
"namespace": "mi_namespace"
},
{
"account": "56900000000",
"name": "despedida",
"body": "Gracias {{1}}, hasta pronto",
"lang": "es",
"namespace": "mi_namespace"
}
]
}'Ejemplo de respuesta exitosa:
{
"status": 200,
"message": "2 templates processed successfully"
}Sincronizar plantillas desde Meta
/v2/whatsapp/templates/sync/ - POST
Sincroniza automáticamente todas las plantillas aprobadas en Meta con tu cuenta de Adereso. Útil después de crear o modificar templates directamente en Meta Business Manager.
Parámetros
Parámetro | Tipo | Requerido | Descripción |
waba_id | string | Sí | ID de tu cuenta WhatsApp Business (WABA ID) |
Ejemplo de request
curl -X POST \
-H "Authorization: Key TU_TOKEN" \
-H "Content-Type: application/json" \
"https://api-cluster.adere.so/v2/whatsapp/templates/sync/" \
-d '{"waba_id": "123456789"}'Ejemplo de respuesta exitosa:
{
"status": 200,
"message": "Templates synced successfully",
"synced": 15
}Códigos de error
Código | Descripción |
400 | WABA ID no proporcionado |
401 | No autenticado |